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Introduction & Scope 


Beginning with an introduction to the purpose and history of Juju, model-driven operations 
and how application management can transform the way businesses manage applications, the 
Juju Administrator course is designed to enable administrators to quickly become proficient 
at managing Juju and deploying, configuring and integrating applications across computing 
substrates. The course is a blend of theory sessions and hands-on practical labs which see 
attendees deploying charmed applications on VMs, containers and Kubernetes clusters. 


The duration of the course is three days. 


Agenda 
Day 1 


Juju Basics 


Agenda 


ey be its 


Introduction Basic introduction to Juju, terminology such as "Charmed Operator", and 
"Operator Lifecycle Manager" 
- Whatis Juju? 
- What problems does Juju solve? 
- Comparison to other tools/methodologies 
-  Ansible/Chef/Puppet 
-  Terraform/Pulumi 
- Generic operator pattern 
- | Operator Framework 
Juju's consistency across substrates 
-  Bare-metal/MAAS/LXD 
- Azure/AWS/GCP/Oracle/Rackspace 
- VMWare 
- Openstack 
- Kubernetes 
Deployment patterns and examples 
-  Applications/stacks on single substrates 
- Applications and services across multiple substrates 
- Charmed <Openstack|Kubernetes|OSM> 
Juju Community 
- Docs 
-  Discourse/Mattermost 
- Charmhub 
-  Github/Launchpad Repos 
Rest of course outline 
Take questions on any of the above 


Demonstration Deploy the Charmed Kubernetes Lite bundle using the Juju dashboard. 10 mins 
This is a suitably complex example that brings into focus the simplicity that 
Juju can bring to complex deployments and illustrates the visual aspect of 


application modelling 


Concepts This section should crystallize the definitions of the various terms used 1 hr 30 mins 
when describing Juju and Charmed Operators. 
- Controllers 
- Controller Function 
- Juju CLI interaction with controller API 
- Controller database and state storage 
-  Single-substrate/multi-substrate controllers 








- JAAS / JIMM 
Charms 
Models 
Applications 
Units 
Leadership 
Charmed Operators 
Events 
Actions 
Config 
Bundles 
Take questions on any of the above 


Break / Informal Q&A | Juju is alot, give people a break ;) 


Advanced Concepts This section should illustrate the more advanced features of Juju and start 1 hr 
#1 to bring into Focus the complex problems it can solve: 
Deployment constraints (memory, cpu, etc.) 
Juju users and credentials 
High-availability controllers 
Subordinate charms 
Relations 
Basics on relations and application integration 
Interfaces 
Relations across different apps (provides/requires) 
Peer relations 
Relation data and persistence 
Cross Model Relations 
Take questions on any of the above 


Demonstration Create a new Juju controller 20 mins 
Deploy wordpress (requires database) 
Deploy mysql (provides database) 
Create the relation between the two applications, and practically 
explain the interaction via relations (provides/requires). 


Advanced Concepts Libraries 30 mins 
#2 Juju on Kubernetes 

- Highlight similarities, not differences 

- Introduce Pebble 


Demonstration Deploy Charmed Kubeflow Lite on MicroK8s and explore the deployment 30 mins 
both in the Juju CLI, Juju Dashboard and using “kubectl’ 





Juju Administrator Part 1 


Agenda 


Ba o ce 


Introduction This section should be used to introduce the course material, explain the 15 mins 
outcomes and what will be achieved in the labs 
- Verify prior knowledge/Juju Basics attendance 
Verify that students have a suitable lab setup 
- Introduce Multipass for creating VMs quickly on physical 


hardware if relevant 
Talk through installing Multipass, LXD, Juju, MicroK8s as required 
Outline the rest of the course 


Adding clouds and Brief recap about Juju Controllers and their purpose 20 mins 
bootstrapping Explain the purpose of `add-cloud/add-credential 

Explain the purpose of “bootstrap” 

Explain what actually happens during a bootstrap on LXD 


Explain what actually happens during a bootstrap on <customer 
preferred cloud(s)> 


Provision a new VM with Multipass 30 mins 
Install and init LXD 

Bootstrap a Juju controller called `lxd01` on LXD 

Bootstrap a Juju controller called micro’ on MicroK8s 

Take questions on any of the above until most students Finish the lab task 


Juju Client Config Cover how the juju client is configured (series of Files in 15 mins 
~/.local/share/juju) 
How to backup the Juju client 
What the purpose of the config files is 


Q&A / Wrap up Recap of key messages: 25 mins 
What problems does Juju solve 
Model-driven ops 
Where to find docs 
Where to learn more/community 





Day 2 


Juju Administrator Part 2 


Agenda 


Applications and 
Models 


Application Scaling 
and Constraints 


Briefly recap applications, units, leadership 
Introduce Charmhub and application versions/channels/revisions 
- Show on charmhub 
- Illustrate the juju info <charm>* command 
Introduce the ‘juju models’ command 
Demonstrate an application deployment and removal 
Discuss application states (active, waiting, blocked, maintenance) 
Introduce the ‘juju status» command 
- Show the detail given when output as YAMLJSON (charm 
revision, uuid, etc) 
Download a charm using ‘juju download’ and open in an archive 
manager, explain the contents of the charm (metadata.yaml, etc) 
Explain the how applications are Formed on Kubernetes and the sidecar 
pattern 


Create a new model on the LXD controller called `hello-juju` 
Deploy the “hello-juju’ application on LXD 
Explore with ‘juju status” 
Explore with `lxc list™ 
Validate access to the webpage 
Scale application up to 3 units, and back down to 1 unit 
Switch models to a MicroK8s model 
Deploy the “hello-kubecon* Kubernetes application 
- Explore the deployment with kubectl 
- Inspect the running containers in the pod 
Take questions on any of the above until most students Finish the lab task 


Illustrate deploying applications to specific machines/containers with 
“juju deploy --to` 
Introduce the “show-status-log’ command 
Introduce application constraints 
- Defined at bootstrap, deploy or add-machine 
- Defined at model or controller scope 
Highlight differences between constraints on public cloud, LXD and 
Kubernetes (max vs min) 
Illustrate setting default model constraints 
Deploy a machine with specific memory and cpu constraints 
Show how to query constraints (‘get-constraints') For an application and 
set post-deploy with 'set-constraints’. 


Deploy “hello-juju> to a fresh model on LXD 
Scale the “hello-juju> application to 3 units 


30 mins 


30 mins 





Set the default model constraints to *mem=2G and `cpu=2` 

Remove ‘hello-juju’ and redeploy, specifying different constraints 

Get the constraints from the recently deployed “hello-juju’ app 

Update the constraints then scale the application 

Switch to the MicroK8s model and scale the `hello-kubecon` app, pay 
attention to how the operator has scaled with the application 

Take questions on any of the above until most students Finish the lab task 


Application Config Briefly recap application config, where it is stored and how itis set 30 mins 
and Actions Show how config items can be set using the CLI 
- At deploy time 
- When deployed 
Illustrate dumping config from running charm as JSON/YAML etc at the 
command line 
Show how config can be passed as a YAML file 
Illustrate config documentation For a charm on charmhub 


Recap charm actions and their purpose 
Demonstrate ‘juju actions’, juju run-action’, “juju show-action-output” 
etc 


Configure “hello-juju> with a new port and site by specifying options at 30 mins 
the command line 

Reconfigure those options by defining the options in a YAML file and 

passing it in 

Discover the actions associated with the “hello-kubecon’ application. Run 


the action and inspect the results. 
Take questions on any of the above until most students Finish the lab task 


Machine Access Explain how machines can be accessed 'in-band' with ‘juju ssh`ò and ‘juju 30 mins 
scp 
Demonstrate accessing a machine by unit name 
Demonstrate copying a file into a machine 
Show executing one-time commands and getting a shell 
Use ‘juju run’ to execute a command 
Talk about accessing out of band 
- SSH directly 
- “Ixc exec” 
- With virsh/virt-manager if the machines are VMs not LXC 
containers 
Briefly demonstrate the juju add-machine’ command - add a new 
machine and another existing machine over SSH (use multipass) 
Switch to the MicroK8s model and use both ‘juju ssh” and “kubectl exec” 
to gain shell access to the charm container in the “hello-kubecon-0° pod 


Access the hello-juju machine using ‘juju ssh” 15 mins 
Find the name of the container using juju status’ and access directly 

using `lxc exec’ 

Add your public key to the machine using a shell gained using ‘juju ssh 

then ssh in using just ssh user@ip` 





Logging - Sources of log information 20 mins 

- Location of logs on disk 
- Use of the ‘juju debug-log’ command 

- Log levels 

- Filter by application/unit 
- Location of agent logs on machines 
- Adjusting the logging level for controllers and applications with ‘juju 

model-config’ 


Set the model-config to include debug logs For units 30 mins 
Remove the “hello-juju’ application 

Redeploy the “hello-juju> application 

Make a configuration change 

Observe the logs in ‘juju debug-log` 

Filter the “juju debug-log> results to only show controller logs 

Filter the “juju debug-log> results to only show hello-juju logs 

Use ‘juju scp to copy the agent log File From “hello-juju/O° to your local 


machine 
Take questions on any of the above until most students Finish the lab task 


Juju Hook Tools & - What are Juju hook tools? 30 mins 
Debugging - — List the hook tools and explain them 
- Explain they are actually all contained in `jujucò and symlinked, similar to 
how busybox works 
- — Explain how they are invoked in the operator Framework 
- How to run a hook tool using ‘juju debug-hooks” 


How to run a hook tool using juju run” 
When you might need to run a hook tool 


Use ‘juju run’ and the `unit-get` hook tool to get the private IP address of | 30 mins 
the deployed hello-juju application 

Get the status of the “hello-juju/O” unit using the `status-get`ò hook tool 

Set the status of the hello-juju application with the “status-set’ hook tool 

Get the config of the hello-juju application using the “config-get’ hook 

tool in JSON format 


Write a debug log message into the juju log using a hook tool 

Set an item in state, then update it, then delete it. Check its value along 
the way 

Take questions on any of the above until most students Finish the lab task 





Day 3 


Juju Administrator Part 3 


Agenda 


ba ee OOOO cen 


Relations Cover relation concepts again 1 Ar 
Relation interfaces 
Relation data Flow 
Hooks Fired in the charm 
Relation data persistence 
Illustrate how relation data is built up 
Talk about peer relations 
- Explain exchanging data between peers using relation data in 
the context of a clustered application eg. mongo or elastic 
Introduce subordinate charms and how they are related to primaries 
- Illustrate deployment of a subordinate charm 
- Show how the subordinate scales with the primary 
Demonstrate how to establish relations explicitly (defining the 
interfaces) and implicitly where there is no ambiguity 


Talk about cross-model relations and explain the use cases 


Deploy postgres and mattermost on microk8s and relate the two 45 mins 
applications 
- Briefly explore the deployment on Kubernetes with “kubectl’ 
and show how applications are built up on Kubernetes 
(stateFulset, pods, persistent volumes, etc) 
Show relations in ‘juju status --relations’ 
Break the relation with ‘juju remove-relation” 
Deploy grafana on MicroK8s and scale to three units, show the peer 
relation established in Juju status 


Remove postgres from the model, redeploy in a different model and 
establish the relation using a cross-model relation 


Storage & Spaces Explain the concepts around storage in Juju - storage pools, supported 90 hr 

storage types 
Explain how storage differs across LXD, MAAS, AWS/Azure/GCP and 
Kubernetes 

- Tailor this section to the substrates the customer works with 

but provide an overview of other options 

Introduce the “add-storage’ and “remove-storage’ commands 
Explain how storage can be attached/detached from units at runtime 

- Caveats for Kubernetes 


Demonstrate how to add storage to a unit ,detach and reattach to a 
different unit 
Introduce Juju Spaces 





Explain how spaces are supported in MAAS, EC2, Azure, Openstack 
Demonstrate how to add a space 

Deploy an application into the new space 

Explain how constraints can be used to restrict models and applications 
to specific network spaces 


Create a new space, define a constraint on the model so that all new 60 mins 
deployed applications are deployed into this space 


Walkthrough this document: [Appendix] Installing Ceph - doc - 


Charmhub 
Add 2 more storage volumes to Ceph OSD 
Remove one of the volumes 


Questions Wrap up session remainde 
Q&A n 





